home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 1999 May / SGI IRIX 6.5 Applications 1999 May.iso / dist / arraysvcs.idb / usr / share / catman / p_man / cat3x / asgetattr.z / asgetattr
Text File  |  1998-10-27  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaassssggggeeeettttaaaattttttttrrrr((((3333xxxx))))                                                    aaaassssggggeeeettttaaaattttttttrrrr((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      asgetattr - search an attribute list for a particular name
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>
  13.  
  14.      ccccoooonnnnsssstttt cccchhhhaaaarrrr ****aaaassssggggeeeettttaaaattttttttrrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****aaaattttttttrrrrnnnnaaaammmmeeee,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ********aaaattttttttrrrrssss,,,,                                       iiiinnnntttt nnnnuuuummmmaaaattttttttrrrrssss))))
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _a_s_g_e_t_a_t_t_r function searches through a list of strings for a
  18.      particular attribute name and returns a corresponding value, similar to
  19.      the way _g_e_t_e_n_v(3C) searches through the environment for a particular
  20.      variable.
  21.  
  22.      The list of strings, aaaattttttttrrrrssss, will typically have been returned by a
  23.      function such as _a_s_l_i_s_t_a_r_r_a_y_s(3X) or _a_s_l_i_s_t_m_a_c_h_i_n_e_s(3X).  The argument
  24.      nnnnuuuummmmaaaattttttttrrrrssss specifies the number of strings in the list.
  25.  
  26.      The attribute to be found is identified by the name aaaattttttttrrrrnnnnaaaammmmeeee.  Attributes
  27.      are assumed to be of the format "NAME=VALUE", so this amounts to
  28.      searching the attributes for the first one that starts with aaaattttttttrrrrnnnnaaaammmmeeee
  29.      followed either by a null or the character "=".  If NAME is not found,
  30.      NULL is returned.  If the attribute is present with no value, a pointer
  31.      to a null character is returned, otherwise a pointer to VALUE is
  32.      returned.
  33.  
  34. NNNNOOOOTTTTEEEESSSS
  35.      _a_s_g_e_t_a_t_t_r is found in the library "libarray.so", and will be loaded if
  36.      the option "-larray" is used with _c_c(1) or _l_d(1).
  37.  
  38. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  39.      aslistarrays(3X), aslistmachines(3X),
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.